/*
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package org.schema.domain.thing;

import java.util.Date;
import org.schema.domain.Thing;
import org.schema.domain.thing.Event;
import org.schema.domain.thing.intangible.Offer;
import org.schema.domain.thing.intangible.quantity.Duration;

/**
 * An event happening at a certain time at a certain location.
 */
public interface Event extends Thing {

	/**
	 * A person attending the event.
	 *
 	 * @return Thing
	 */
	Thing getAttendees();

	/**
	 * A person attending the event.
	 *
 	 * @param thing
	 * @return void
	 */
	void setAttendees(Thing thing);

	/**
	 * The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
	 *
 	 * @return Duration
	 */
	Duration getDuration();

	/**
	 * The duration of the item (movie, audio recording, event, etc.) in ISO 8601 date format.
	 *
 	 * @param duration
	 * @return void
	 */
	void setDuration(Duration duration);

	/**
	 * The end date and time of the event (in ISO 8601 date format).
	 *
 	 * @return Date
	 */
	Date getEndDate();

	/**
	 * The end date and time of the event (in ISO 8601 date format).
	 *
 	 * @param date1
	 * @return void
	 */
	void setEndDate(Date date1);

	/**
	 * The location of the event or organization.
	 *
 	 * @return Thing
	 */
	Thing getLocation();

	/**
	 * The location of the event or organization.
	 *
 	 * @param thing
	 * @return void
	 */
	void setLocation(Thing thing);

	/**
	 * An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
	 *
 	 * @return Offer
	 */
	Offer getOffers();

	/**
	 * An offer to sell this item—for example, an offer to sell a product, the DVD of a movie, or tickets to an event.
	 *
 	 * @param offer
	 * @return void
	 */
	void setOffers(Offer offer);

	/**
	 * The main performer or performers of the event—for example, a presenter, musician, or actor.
	 *
 	 * @return Thing
	 */
	Thing getPerformers();

	/**
	 * The main performer or performers of the event—for example, a presenter, musician, or actor.
	 *
 	 * @param thing
	 * @return void
	 */
	void setPerformers(Thing thing);

	/**
	 * The start date and time of the event (in ISO 8601 date format).
	 *
 	 * @return Date
	 */
	Date getStartDate();

	/**
	 * The start date and time of the event (in ISO 8601 date format).
	 *
 	 * @param date1
	 * @return void
	 */
	void setStartDate(Date date1);

	/**
	 * Events that are a part of this event. For example, a conference event includes many presentations, each are subEvents of the conference.
	 *
 	 * @return Event
	 */
	Event getSubEvents();

	/**
	 * Events that are a part of this event. For example, a conference event includes many presentations, each are subEvents of the conference.
	 *
 	 * @param event
	 * @return void
	 */
	void setSubEvents(Event event);

	/**
	 * An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
	 *
 	 * @return Event
	 */
	Event getSuperEvent();

	/**
	 * An event that this event is a part of. For example, a collection of individual music performances might each have a music festival as their superEvent.
	 *
 	 * @param event
	 * @return void
	 */
	void setSuperEvent(Event event);

}